home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 27 / Mac Magazin and MacEasy Magazine CD - Issue 27.iso / Utilities / TattleTech 2.53 Folder / TattleTech 2.53 / TattleTech 2.53.rsrc / TEXT_5561_General Help.txt < prev    next >
Text File  |  1996-09-27  |  16KB  |  162 lines

  1. What is TattleTech?
  2.     TattleTech provides extensive information about your computer, peripherals, and system software.  The information can be viewed on screen by category, printed, written to a standard text file in standard or a special Bug Report format, or output in database readable format.  As such, it also provides a record of your system configuration that can be used for reporting problems to software and hardware manufacturers, to compare configurations across multiple computers, or to simply learn about your machine. In addition, it enables you to Mount Volumes, Close Files that were left open, and examine and set File and Folder Attributes.  The information provided varies greatly among these categories and is best understood simply by going to the dialog window and browsing through the above categories.
  3.     NOTES:  If you received this copy of TattleTech as part of another product, some of the features mention above may not be available.  Methods for contacting Decision Maker‚Äôs Software may be found at the end of this document.  
  4.  
  5. System Requirements
  6.     TattleTech is compatible with the Mac+ and newer machines running System 7 or higher. 
  7.  
  8. Installing TattleTech
  9.     TattleTech consists of up to three files for operation:
  10.  
  11. ‚Ä¢    TattleTech
  12. ‚Ä¢    TattleINIT
  13. ‚Ä¢    Tattle.Traps
  14.  
  15.     TattleINIT is not required for normal operation of TattleTech.   TattleTech defaults to using internal INIT information generating routines if the generated files are not found.  TattleINIT, if used, must be in the Extensions folder. TattleINIT should be placed alphabetically at the beginning of the folder so the program can gather information on all subsequently loaded INITs. Its name is preceded by two non-printing characters to facilitate this.  These two non-printing characters may be changed to other non-printing characters to accommodate INIT ordering requirements. (see Conflicts and Limitations below)
  16.     When TattleINIT runs at startup, it creates two files in the System Folder: TTINIT.TRecs and TTINIT.FRecs. These files contain information about the INITs that run after TattleINIT,  and are used by TattleTech in subsequent reports.  The first time TattleTech is run after start-up it converts these two files to TTINIT.TDB and TTINIT.FDB respectively.
  17.     Tattle.Traps, is required for all of the Trap-related reports except the Traps Patched by INITs report.  Tattle.Traps if used, must be located either in the same folder as TattleTech or the System Folder.  If you need to specify another location for Tattle.Traps, you can do so using the ‚ÄúChange Traps File‚Äù menu command.
  18.     In addition to the files listed, there are a number of files that provide for Registration and other support for TattleTech.  Please refer to the manual for more information.  
  19.  
  20. Using TattleTech
  21. Selecting Categories From the Main Dialog Window
  22.     TattleTech consists primarily of the TattleTech dialog window and the TattleTech menu. Upon launch, the Main dialog window is visible and the first Category of information, General Hardware, is displayed in a scrolling "Screen Report" in the window.  You can select other Categories from the pop-up menu above the list.  Categories that are not available for a given computer and system software combination (e.g., Nubus on a Mac+) are disabled and cannot be selected. 
  23.  
  24. Definitions
  25.     The Definitions button at the bottom of the dialog displays definitions for the fields contained in the displayed Category.
  26.  
  27. Other Buttons/Functionality
  28. ‚Ä¢ Applications and DAs:  If you hold down the <option> key before selecting these menu items, the listing will be alphabetically sorted across volumes.   This is also true if the <option> key is held down while choosing Reports... from the TattleTech pull down menu.
  29. ‚Ä¢ File/Folder Info‚Ķ:  The Set‚Ķ button invokes a dialog which allows you to set various attributes related to the file or folder currently displayed. 
  30. ‚Ä¢ Network:  When running OpenTransport, holding the <cmd> key before selecting this report from the menu forces TattleTech to load Open Transport TCP so that actual information (e.g. the connected DNS name) may be accessed.  In contrast, if Open Transport TCP is already loaded (e.g. Netscape is already running in the background), the <option> key prevents TattleTech from accessing this same information.
  31. ‚Ä¢ Nubus/PDS Slots:  The All Slots checkbox forces the list to include slots with assigned functionality but no physical slot card.  This is also true if the <cmd> key is held down while choosing Reports... from the TattleTech pull down menu. 
  32. ‚Ä¢ Open Files:  The Close‚Ķ button invokes another dialog which allows you to close any open file in the list.  This Category also has a special listing feature.  If you hold down the <option> key before selecting this menu item, any open Font files will not be listed.
  33. ‚Ä¢ System Files (Other):  If you hold down the <option> key before selecting this menu item, only Special Files in the System Folder specified with  Configure TattleTech will be listed.  If you hold down the <shift> key before selecting this menu item, all other system files will be listed. 
  34. ‚Ä¢ Volumes:  The Mount button attempts to mount any unmounted volumes.  
  35.     
  36. Copying Data Fields to Other Applications
  37.     Data Field lines in the "Screen Report" can be selected and copied to other documents using the standard copy and paste commands.
  38.  
  39. Closing and Quitting
  40.     Click the Close button or the Close box to close the window but leave TattleTech active.  Get System Info in the TattleTech menu reopens the window.  Select Quit from the File menu to quit completely.
  41.  
  42. Getting Help
  43.     Selecting General Help... from the TattleTech menu activates an abbreviated on-line version of the TattleTech manual.
  44.  
  45. Printing the Current Category
  46.     Select Print Current...  from the TattleTech menu to print the Category that is currently displayed in the dialog.
  47.  
  48. Page Setup
  49.     Select Page Setup‚Ķ to set parameters for printing report pages.
  50.  
  51. Specifying Volumes
  52.     Specify Volume allows you to restrict the volumes for which files are reported.  This menu item applies only to the Special Files, Applications, and DAs (System 7) reports available in the pop-up menu.
  53.  
  54. Generating Reports
  55.     Select Reports... from the TattleTech pull down menu.  Select the Categories you want to report by selecting their checkboxes. Click the All button to select all Categories. Click the None button to de-select the Categories.  Select Default Reports to choose the standard preset Categories. 
  56.  
  57. TattleTech Reports
  58.     TattleTech provides several options for reporting the different Categories of information.  The following is a list of available reports:
  59.  
  60. ‚Ä¢    "Screen Report" (See Selecting Categories From the Main Dialog Window above.)
  61. ‚Ä¢    "Printed Report"
  62. ‚Ä¢    "Standard Text File Report"
  63. ‚Ä¢    "Bug Report"
  64. ‚Ä¢    "Tab-Delimited Text File Report"
  65.  
  66. "Printed Report"
  67.     To print the selected Categories to a printer, select the Categories that you want to print, click the Print Std Reports button, and then click OK.
  68.  
  69. Writing Reports to a Text File
  70.     Writing reports to text files offers flexibility in communicating and using the information that TattleTech provides.   In addition, TattleTech uses the standard List Manager for both "Screen Reports" or "Printed Reports" and is therefore limited to 32K characters. Normally this is sufficient to handle the various lists within each Category.  If a list runs out of space, however, a message is posted at the bottom of the list window. In this case, a full listing of the Category can be obtained by writing the Category report to the various forms of text files as described below.
  71.  
  72. Writing a "Standard Text File Report" 
  73.     To write the selected Categories to the "Standard Text File Report", click the Write Std Reports to Text File radio button.
  74.  
  75. Writing a "Bug Report" to a Text File
  76.     Click the Write Bug Report to Text File radio button to add "bug report" information to the "Standard Text File Report".
  77.     Clicking the Bug Explanation... button accesses a dialog that allows you to describe the problem and to Save and Load the text that you have created for future reference. 
  78.     The User Info... button allows you to input standard information including who you are and how you can be contacted.  This information is read at program startup and is retained until changed by you.  
  79.  
  80. Note:    
  81.     Generally, in cases where a particular Data Field is not an appropriate or possible attribute of a particular machine configuration, that attribute is not included in any report other than the "Tab-Delimited Text File Report". (Please refer to Writing the "Tab-Delimited Text File Report".)  An example of this would be the reporting of DuoDock attributes for a Quadra, which cannot possibly have a DuoDock.  
  82.  
  83. Writing the "Tab-Delimited Text File Report"
  84.     To write the selected Categories to the "Tab-Delimited Text File Report" and thereby create a database-readable file, click the Write to Tab-Delimited Text File radio button. 
  85.  
  86. Set Unit Info
  87.     Click the Set Unit Info... button in the same dialog to enter information related to the owner of the system. Click the Unit Info checkbox to place this information at the beginning of the three text file reports ("Standard Text File Report", "Bug Report", and "Tab-Delimited Text File Report").  The information is preserved the next time TattleTech is launched.
  88.  
  89.  
  90. ‚Ä¢ Conflicts and Limitations
  91.     This section describes conflicts with other software and system limitations that affect TattleTech.
  92.  
  93. Accelerator Cards
  94.     Two conditions involving accelerator cards affect TattleTech.  First, if your Macintosh has an accelerator card installed that copies ROM to RAM, you may need to disable this feature to run TattleTech. This problem occurs primarily on the Mac+/SE, but may occur with other configurations.
  95.     Second, if you have a Daystar Accelerator and:
  96. ‚Ä¢    PowerCentral v2.0 with Enhanced FP routines is enabled, and
  97. ‚Ä¢    QuickTime or Apple Photo Access is installed,
  98.     then you must disable Daystar Enhanced FP routines in the control panel.
  99.  
  100. Extension Manager
  101.     If you are running Extension Manager, EM Extension must be placed before TattleINIT in the Extensions folder.
  102.  
  103. List Manager
  104.     To conserve space, TattleTech uses the standard List Manager for both "Screen Reports" or "Printed Reports" and is therefore limited to 32K characters. Normally this is sufficient to handle the various lists within each Category. If a list runs out of space, however, a message is posted at the bottom of the list window. In this case, a full listing of the Category can be obtained by writing the Category report to the various forms of text files as described in Writing Reports to a Text File.
  105.  
  106.  
  107. ‚Ä¢ BUG¬†REPORTS:
  108. Bug reports and suggestions are HIGHLY valued and MUCH appreciated.  If at all possible, please report problems using the following method:
  109.  
  110. 1)  Choose "Reports‚Ķ" from the TattleTech menu
  111. 2)  Select the "Write Bug Reports to Text File" radio button
  112. 3)  Fill in as much of the "Bug Information‚Ķ" and "User Info‚Ķ" dialogs as you have the patience to do
  113. 4)  Select the report(s) with which you are having the problem (and any others that you feel are appropriate) to the ones already selected
  114. 5)  Hit OK, name the file (just using your "firstname_lastname.TEXT" works great) and email the resulting text file to me
  115.  
  116. If the bug crashes while generating a particular report, please do the following:
  117. 1)  Follow the above procedure selecting all reports except the problem (crashing) report
  118. 2)  Choose "Reports‚Ķ" again.
  119. 3)  Hold down the <option> key and select the "Write Bug Reports to Text File" radio button.  "[Flush]" should now appear at the end of this button name. 
  120. 4)  Select the problem report only.  
  121. 5)  Hit OK and add a "2" to whatever name you gave to the first file.  Even though you will still crash when generating the report, this will generate a report file which indicates exactly where the problem is occuring in the report.
  122. 6)  Email both report files to me
  123.  
  124. If you crash before TattleTech finishes loading, please try holding down the <cmd> key while launching TattleTech.  This will prevent the "General Hardware" report from running automatically - this report is probably the culprit.  You can then complete the reporting process by treating "General Hardware" as the problem report.
  125.  
  126. If you don't have the time and/or inclination for any of this reporting process, please just email a description of the problem and an indication of your willingness to run additional tests if necessary.
  127.  
  128. In either event, thank you in advance for your time and patience!
  129.  
  130. ‚Ä¢ REGISTRATION:  This product is not free.  Please refer to the accompanying Registration/Pricing document for details on how to Register using Configure TattleTech.
  131.  
  132. ‚Ä¢ LICENSE AGREEMENT: 
  133.     Any entity who distributes and/or uses TattleTech¬Æ and any other accompanying software and documentation (‚ÄúLicensee‚Äù) agrees to be bound by this License Agreement.  
  134.     The TattleTech program is copyrighted and the TattleTech¬Æ name is a registered trademark.  TattleTech, its documentation, and any accompanying software represent proprietary program products and information of Decision Makers Software, Inc. (‚ÄúLicensor‚Äù).  Licensee agrees not to reverse engineer, disassemble or decompile the licensed software in whole or part. Licensee may modify the licensed software only in the manner provided for either by the software itself or through ancillary programs provided by the Licensor expressly for modification or customization purposes.  
  135.     All rights under the copyright laws are reserved.
  136.  
  137. Warranty:  (Applies Only to Registered Users)
  138.     Licensee acknowledges that all licensed software items are of such complexity that they may have inherent defects, and agrees that as Licensor's sole liability and as Licensee's sole remedy, Licensor will attempt to provide services to correct documented errors that Licensor's diagnosis indicates are caused by a defect in an unaltered version of the delivered licensed software. Licensor does not guarantee the results of any such services or represent or warrant that any or all errors will be corrected.  This warranty only applies to Licensees who have Registered with the Licensor.
  139.  
  140. Limitation of Liability: 
  141.     Except for the express warranty set forth above, Licensor grants no warranties, either express or implied, with regard to any licensed software including, but not limited to, merchantability and fitness for a particular purpose. The stated express warranty is in lieu of all liabilities or obligations of Licensor for damages arising out of or in connection with the delivery, use, or performance of licensed software. In no event shall Licensor be liable for incidental or consequential damages.  Licensee also agrees to indemnify Licensor for any and all claims made by any entities to whom they distribute TattleTech.
  142.     Any use not in conformance with this Software License Agreement is expressly prohibited.
  143.  
  144. ‚Ä¢ DISTRIBUTION 
  145.     TattleTech may be freely distributed in its Pre-Registered form at no charge except media costs or normal downloading charges provided that all documentation, auxiliary programs, registration and pricing information, and all other files in their original form accompany it.  Any inclusion on media greater in capacity than 1.4 MB must be approved in advance.  In addition, it may not be used, sold, included with other software sold commercially, or utilized in any commercial venture not already delineated without either payment of the appropriate Registration Fee or specific permission from Decision Maker‚Äôs Software, Inc.  If you are in doubt, please contact us.
  146.  
  147. TattleTech ¬©1991-1993, Decision Maker‚Äôs Software, Inc., All Rights Reserved
  148.  
  149. ‚Ä¢ CREDITS 
  150.     A special thanks to Rene Ros, publisher of the Gestalt Selector List.  The Gestalt information contained in his list is used to generate a considerable amount of the data provided by TattleTech.
  151.  
  152. Issues regarding licensing, marketing, and general business issues should be sent to:
  153.  
  154. Decision Maker‚Äôs Software, Inc
  155. 1910 Joslyn Place 
  156. Boulder, CO  80304
  157. Fax 303/449-6207
  158.  
  159. Internet: mancino@decismkr.com
  160. AppleLink: D0391    
  161. America Online: JGCMan
  162. Compuserve: 70337,2143